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1 . 0  SCOPE 


1.1  Identification 


This  specification  establishes  the  requirements  for  the  MAPSE 
Text  Editor.  The  Text  Editor  provides  basic  editing  facilities 
suitable  for  editing  general  text  such  as  program  source  or  program 
documentation. 


1.2  Functional  Summary 

The  design  of  the  MAPSE  editor  is  largely  based  on  the  highly 
popular  ex  or  vi  editor  developed  at  the  University  of  California, 
Berkeley,  under  various  corporate  and  government  grants.  The 
system,  which  runs  under  UNIX,  has  been  documented  by  William  Joy  of 
the  Department  of  Electrical  Engineering  and  Computer  Science  at 
UCB,  and  is  in  general  distribution.  This  model  was  chosen  due  to 
its  wide  range  of  applicability  and  its  wide  acceptance  in  the  user 
community.  It  is  felt  that  an  editor,  being  one  of  the  most  highly 
user-interactive  parts  of  the  MAPSE,  should  be  based  on  a  design 
which  has  been  shown  to  be  successful. 


The  MAPSE  Text  Editor  is  the  basic  tool  for  the  creation  and 
modification  of  textual  material.  The  edited  material  resides  in 
the  MAPSE  database  and  is  created  or  modified  interactively  through 
the  editor.  The  editor  operates  on  a  copy  of  the  object  in  its 
"edit  buffer".  The  original  object  itself  is  not  modified  until  the 
user  so  requests.  The  editor  may  be  operated  in  various  modes  as 
appropriate  to  the  sophistication  of  the  user  and  the 
characteristics  of  the  terminal  device: 

-  Command  commands  are  entered  when  a  ’>'  prompt  is 

Mode:  present  and  are  executed  each  time  a  complete 

line  is  entered  (terminated  by  a  carriage 
return  or  "new  line").  Sufficient  commands  are 
available  to  allow  flexible  editing  of  a  file 
from  even  hardcopy,  low-speed  terminals. 
Command  functions  include:  find,  alter, 

insert,  delete,  input,  output,  move,  copy  and 
substitute. 


-  Text  the  editor  gathers  input,  line  by  line,  and 

Input  Mode:  places  it  in  the  edited  file.  No  prompting  is 

done  and  the  user  must  leave  Text  Input  Mode 
explicitly.  This  mode  is  the  basic  method  for 
adding  lines  to  a  file. 
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-  Full  a  superset  of  Conunand  mode.  On  appropriate 

Screen  Mode:  CRT  terminals,  the  CRT  screen  is  made  a 

"window"  into  the  file  being  edited;  a 
contiguous  block  of  the  file's  text  is 
displayed.  The  terminal's  cursor  is  used  to 
"move  around"  in  the  text  and  cursor  commands 
may  be  given  (with  effects  such  as  "delete  the 
character  at  the  cursor  location"  or  "move 
cursor  forward  one  word").  All  of  the  "line 
commands”  of  the  basic  Command  mode  are 
available:  the  user  may  issue  these  commands 

on  the  "command  line"  of  the  display  and  see 
the  effects  reflected  in  the  block  of  text 
shown  in  the  terminals  full  display. 

The  editor  begins  operation  in  the  simpler  Command  mode.  The  user 
may  invoke  the  more  sophisticated  features  as  needed. 

In  addition  to  standard  editing  (text  manipulation)  features, 
the  editor  provides  a  few  simple  additional  capabilities,  which 
enhance  its  utility  in  the  KAPSE  environment.  These  include: 

-  File/object  handling.  The  ability  to  write  all  or  part  of 
the  object  under  edit  into  another  named  object,  plus  the 
ability  to  read  a  named  object  into  the  editor's  edit  buffer 
(e.g.,  to  include  one  file  in  another). 

-  KAPSE  or  user  program  invocation.  The  ability  to  "escape"  to 
the  KAPSE  or  user  program  from  within  the  editor  and, 
optionally,  pass  portions  of  the  edited  object  to  the  program 
as  input.  Correspondingly,  the  output  of  such  an  invoked 
program  may  be  read  into  the  edit  buffer.  This  allows,  for 
instance  (presuming  the  existence  of  a  sorting  program),  the 
invocation  of  a  sort  program  with  the  buffer  contents  as 
input  and  the  replacement  of  the  buffer  contents  with  the 
sort  program's  output. 

-  User  controlled  options.  A  set  of  options  that  parameterize 

some  of  the  editor's  functions  is  provided.  Generally,  these 
are  used  to  set  default  counts  or  modes  for  various  commands. 
Examples  are:  (1)  setting  tabstops  to  be  every  "n" 

positions;  or  (2)  setting  a  "wrap  right  margin"  mode  in  which 
the  editor  automatically  senses  the  approach  of  the  right 
margin  during  text  input  and  breaks  the  input  line  at  a  blank 
near  the  margin.  This  is  useful  for  documentation  input  when 
the  typist  is  more  effective  if  margins  are  "automatic". 
(This  mode  is  similar  to  those  provided  on  many  stand-alone 
word  processors. ) 

-  Edit  Scripts.  The  ability  to  use  a  "canned"  set  of  edit 
commands  out  of  a  file.  Commonly  used  edit  sequences  can  be 
saved  and  applied  during  later  edit  sessions. 
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2.0  APPLICABLE  DOCUMENTS 

Please  note  that  the  bracketed  number  preceding  the  document 
identification  is  used  for  reference  purposes  within  the  text  of 
this  document. 


2 . 1  Government  Documents 

[G-l]  Reference  Manual  for  the  Ada  Programming  Language , 
proposed  standard  document,  July  1980 . 

2 . 2  Non-Government  Documents 

[1-1]  System  Specification  for  Ada  Integrated  Environment, 
Type  A,  Intermetrics,  Inc.,  March  1981,  IR-676. 

Computer  Program  Development  Specifications  for  Ada  Integrated 
Environment  (Type  5): 

[1-2]  Ada  Compiler  Phases,  IR-677. 

[1-3]  KAPSE/Database,  IR-678. 

[1-4]  MAPSE  Command  Processor,  IR-679. 

[1-5]  MAPSE  Generation  and  Support,  IR-680. 

[1-6]  Program  Integration  Facilities,  IR-681. 

[1-7]  MAPSE  Debugging  Facilities,  IR-682. 

[1-8]  Technical  Report  (INTERIM),  IR-684. 
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3.0  REQUIREMENTS 


3.1  Program  Definition 

The  MAPSE  Text  Editor  provides  a  framework  within  which 
different  kinds  of  structured  and  unstructured  text  may  be  edited. 
It  must  interface  with  the  file  system  and  the  general  KAPSE 
environment  on  the  one  hand  and  the  user  (through  the  user's 
terminal)  on  the  other. 

A  user  invokes  the  Editor,  specifying  a  database  object  that  is 
to  be  manipulated.  The  editor  creates  a  copy  of  the  object  in  its 
edit  buffer  and  interprets  user  commands  to  effect  changes  to  the 
buffer's  contents.  The  buffer  is  copied  into  the  database  (into  its 
original  object  or  another)  at  user  request.  The  editor  can  be  used 
to  create  an  object  if  it  does  not  exist.  The  detailed  functional 
requirements  of  the  MAPSE  text  editor  are  dictated  primarily  by  the 
command  language  which  it  supports.  The  description  of  that  command 
language  is  found  in  Section  3.2. 


3.1.1  Source  Management  and  the  Text  Editor 

The  MAPSE  Text  Editor  is  the  primary  means  for  creating  and 
editing  source  text,  both  programs  and  documentation.  As  such,  the 
Editor  provides  an  important  user  interface  to  the  KAPSE  facilities 
used  for  source  management. 

Each  text  object  in  the  KAPSE  database  is  a  component  of  a 
composite  object,  and  has  a  set  of  distinguishing  attributes  which 
differentiate  it  from  all  other  components  of  this  composite  object. 
To  edit  a  particular  text  object,  the  user  specifies  an  access  path 
going  through  some  window  with  a  capacity  that  provides  appropriate 
access  rights  to  all  or  part  of  the  composite  object  enclosing  it 
[1-3] .  The  access  path  identifies  the  window  and  then  specifies  the 
distinguishing  attributes  of  the  component,  in  the  general  forms 

w  i  ndow_name .  d  i  s  t  _a  1 1  _1 .  d  i  s  t_a  1 1  _2 . d  i  s  t_a  t  t_N 

For  example: 

WORKSPACE. SHUTTLE. INITIALIZATION. PKGJSPEC 

The  editor  can  be  used  to  create  a  totally  new  text  object,  or 
to  edit  an  existing  text  object.  In  both  cases,  the  editor 
automatically  takes  advantage  of  KAPSE  facilities  for  source 
archiving,  synchronization,  and  access  control. 

When  creating  a  new  text  object,  the  editor  uses  the  KAPSE 
history  facilities  to  establish  it  as  the  beginning  of  a  new  source 
archive.  Future  edits  to  the  object  will  all  be  remembered  in  this 
source  archive,  allowing  for  the  possibility  of  recreating  past 
revisions  and  preventing  catastrophic  loss. 
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When  editing  an  existing  object,  the  user  may  specify  either 
that  the  revised  contents  should  replace  the  original  contents  of 
the  object,  or  that  the  revised  contents  should  be  stored  under  a 
new  name  (with  some  new  value  for  a  distinguishing  attribute).  In 
either  case,  the  editor  specifies  (with  the  history  attribute  of  the 
revision)  that  it  is  derived  from  the  original  object  and  is  a 
member  of  the  same  source  archive. 

Synchronization  is  effected  by  opening  the  output  object, 
whether  it  has  the  same  or  a  new  name,  with  reservation  for 
EXCLUSIVE_WRITE •  By  so  doing,  the  editor  ensures  that  no  other  user 
can  simultaneously  create  or  edit  this  object. 

The  KAPSE  access  control  verifies  that  the  user's  window (s) 
provide  the  necessary  access  rights  —  SELECT_COMPONENT  and  READ  of 
the  input  object,  and  CREATE_COMPONENT  (if  new)  and  WRITE  of  the 
output  object. 

As  a  final  aid  to  effective  source  management,  the  editor 
allows  the  user  to  record  for  posterity  the  purpose  of  the  editing 
session.  The  editor  saves  the  user's  declared  purpose  as  the  value 
of  a  non-distinguishing  attribute  labeled  PURPOSE_FOR  REVISION.  The 
editor,  of  course,  cannot  force  the  user  to  gTve  meaningful 
comments,  but  by  making  the  process  painless  and  automatic,  it  gives 
the  conscientious  user  a  medium  to  record  information  which 
otherwise  might  be  lost  or  forgotten. 

As  a  result  of  this  standard  editing  procedure,  the  user  and 
his/her  manager  are  provided  with  a  useful  record  of  the  development 
of  a  piece  of  text,  as  well  as  being  protected  against  improper  or 
mistaken  modification  to  important  source  documents. 

3.1.2  Interfaces 

The  editor  determines  device  characteristics  from  the  KAPSE  via 
GET^INPUT_INFO  and  GET_OUTPUT_INFOR.  Within  the  limits  of  the 
device,  the  KAPSE  translates  the  standard  set  of  device  control 
character  sequences  into  the  specific  codes  appropriate  to  the 
particular  terminal.  The  editor  uses  SET_COL  and  SET  LINE  of  the 
extended  TEXT_IO  package  [1-3,  3. 2.8.4]  to  controT  cursor  or 
print-head  movement. 

The  editor  is  able  to  deal  with  a  variety  of  devices 
(line-at-a-time  hardcopy  through  full  function  "smart"  CRTs)  by 
knowing  specific  terminal  characteristics*  These  characteristics 
include  control  (input  and  output)  sequences  for  common  functions 
such  as: 

-  clear  screen 

-  erase  to  end-of-line 

-  hardware  character  and  line  insert/delete 
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The  editor  uses  standard  KAPSE  functions  for  manipulation  of 
database  objects.  Also,  the  KAPSE  is  used  for  invoking  user  or 
system  programs  under  the  editor  and  passing/receiving  data  to/from 
those  programs.  The  editor  operates  as  a  standard  Ada  program  in 
the  KAPSE  environment. 


3 . 2  Detailed  Functional  Requirements 

Due  to  the  highly  interactive  nature  of  a  text  editor,  the 
traditional  breakdown  of  requirements  into  Inputs,  Processing,  and 
Outputs  has  been  combined  below  under  the  general  topic  of  the 
command  language  and  its  effects  on  the  edited  object  and  the 
editor  ’s  environment. 


3.2.1  Invocation 

The  editor  is  invoked  as  a  standard  Ada  program,  specifying  the 
object  to  be  edited  as  an  argument  as  in: 

EDIT  X 

The  argument  (X)  is  prepared  for  editing  and  becomes  the  current 
file  name. 


An  optional  second  argument  may  be  supplied,  which  specifies 
the  location  from  which  the  editor  will  initially  read  commands. 
This  second  argument  is  used  to  operate  the  editor  in  a  "batch"  mode 
as  in: 


z_  EDIT  X,  SCRIPT 

If  the  optional  second  argument  is  omitted,  the  default  command 
source  is  the  user’s  terminal  and  a  conventional  interactive  edit 
session  proceeds. 


3.2.2  The  Edit  Buffer 

In  order  to  perform  its  tasks,  the  editor  sets  aside  a 
temporary  work  space,  called  a  "buffer",  separate  from  the  user’s 
permanent  database  object.  Before  starting  to  work  on  an  existing 
object,  the  editor  makes  a  copy  of  it  in  the  buffer,  leaving  the 
original  untouched.  All  editing  changes  are  made  to  the  buffer 
copy,  which  must  be  written  back  into  the  database  in  order  to 
update  the  old  version  or  create  a  new  object.  The  buffer 
disappears  at  the  end  of  the  editing  session.  If  the  user  attempts 
to  end  the  editing  session  prior  to  saving  a  changed  buffer,  the 
editor  requests  verification  from  the  user. 
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3*2.3  Basic  Editing  Modes  -  Command  and  Text  Input 

Command  and  Text  Input  modes  are  available  on  all  terminals# 
They  are  line-oriented  and  are  entered  a  line  at  a  time  in  response 
to  a  prompt. 

The  text  in  the  edit  buffer  is  considered  to  be  unique  lines, 
each  line  identifiable  by  its  location  in  the  buffer;  i.e.,  its 
count,  starting  at  1.  The  count  always  reflects  the  current  buffer 
contents.  This  means  that  addition  or  deletion  of  lines  may  affect 
the  number  (count)  of  subsequent  lines.  The  line  number  does  not 
physically  exist  in  the  edited  text;  it  is  merely  an  index  used  by 
the  editor.  (A  submode  of  the  editor  can  be  used  to  cause  the  line 
numbers  to  be  displayed  whenever  a  line  is  displayed.) 


3. 2. 3.1  Command  Structure 

Most  commands  are  English  words.  The  first  character  (or  two) 
are  usually  acceptable  abbreviations.  (The  ambiguity  of 
abbreviations  is  resolved  in  favor  of  the  more  commonly  used 
commands. )  For  example,  to  delete  the  current  line  the  user  would 
type:  delete#  To  delete  the  eighth  line  of  the  buffer,  8delete  (or 
ad)  is  used.- 

Most  commands  accept  prefix  addresses,  specifying  the  lines  in 
the  file  upon  which  they  are  to  have  an~e£ f ect .  The  forms  of  those 
addresses  are  discussed  below.  A  number  of  commands  also  may  take  a 
trailing  count,  specifying  the  number  of  lines  to  be  involved.  If  a 
command  takes  any  other  information  or  parameters,  this  information 
is  always  given  after  the  command  name.  Examples:  IQd  deletes  line 
10  while  lQdlO  deletes  10  lines  starting  at  line  10. 


3. 2. 3. 2  Command  Addressing  Primitives 

The  following  notation  is  used  to  address  specific  lines  in  the 
edit  buffer.  These  address  primitives  are  combined  with  command 
names  to  direct  execution  of  the  command. 


Primitive 


Function/Meaning 


.  The  current  line.  Most  commands  leave  the 

current  line  as  the  last  line  which  they  affect. 
The  default  address  for  most  commands  is  the 
current  line. 

n  The  nth  line  in  the  editor's  buffer. 

$  The  last  line  in  the  buffer. 
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Primitive 

+n 

-n 


Function/Meaning 

An  offset  relative  to  the  current  buffer 
line. 


/pattern/  Scan  forward  or  backward,  respectively,  for  a 
?pattern?  line  containing  "pattern",  a  sequence  of 
characters  (including  "wild  cards")  which  are  to 
be  matched. 


M  "Marked"  lines.  Any  line  may  be  marked  (the 

'x  mark  command)  with  a  letter  from  a  to  z.  A 

marked  line  is  addressed  by  'x  when  x  is  the 
marking  letter.  The  form  "  is  a  special  case 
which  is  always  maintained  by  the  editor  to 
address  the  previous  current  line. 


3. 2. 3. 3  Combining  Addressing  Primitives 

Addresses  to  commands  consist  of  a  series  of  two  or  more 
addressing  primitives  separated  by  or  Such  addresses  are 
evaluated  left  to  right.  When  addresses  are  separated  by  the 
current  line  ('.')  is  set  to  the  value  of  the  addressing  expression 
which  precedes  the  before  the  next  address  is  interpreted.  If 
a  command  takes  two  addresses,  the  first  addressed  line  must  precede 
the  second  in  the  buffer. 


Examples 

of  line  addresses: 

• 

The  current  line 

.+i 

The  line  after  the  < 

5 

Line  5 

5,10 

Lines  5  through  10 

. -1 , +6 

Lines  4  through  11 

$-10; .+3 

Tenth  to  last  line 
(same  as  $—10,$— 7) 

>.4  Basic 

Command  Descriptions 

The  following  form  is  a  prototype  for  all  line  commands: 
<address>  command  parameters >  < count >  <flags> 


All  parts  are  optional)  the  degenerate  case  (a  carriage  return  or 
new  line  with  nothing  typed  before  it)  is  the  empty  command,  which 
is  interpreted  as  a  special  case  and  causes  the  next  (.+1)  line  in 
the  buffer  to  be  displayed. 
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Flags  may  appear  optionally  after  commands.  The  flags  allowed 
are  1  #f,  *p\  and  • 1* .  If  an  optional  flag  is  used,  the  command 
abbreviated  by  these  characters  (number,  print,  or  list)  is  executed 
after  the  command  completes. 

In  the  following  command  descriptions,  the  default  addresses 
are  shown  in  parentheses,  which  are  not,  however,  part  of  the 
command. 

Append 

(.) append  abbr:  a 

<text > 

.  Places  editor  into  Text  Input  mode.  Lines  are 

read  from  the  terminal  and  placed  after  the 
addressed  line.  A  single  on  an  input  line 

terminates  Text  Input  mode  and  returns  the 
editor  to  Command  mode. 

Example: 

$append  adds  line  to  end  of  buffer 
Oappend  adds  lines  to  beginning  of 
buffer. 


( . , .  )change<count>  abbr:  c 
Ctext > 

.  Replaces  the  specified  lines  with  the  input 

<text>.  Input  is  terminated  by  a  single  1 
If  no  <text>  is  input,  the  effect  is  as  a 
delete. 


Copy 

( . , . )copy <addr >  abbr:  co 

A  copy  of  the  specified  lines  is  placed  after 
<addr >. 


Example: 

5,10copy0  puts  a  copy  of  line  5  through  10  at 
the  beginning  of  the  buffer* 
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Delete 


( . , . )delete<buf fer><count> 

abbr :  d 

Removes  the  specified  lines  from  the  edit  buffer. 
Optionally,  a  "named  buffer"  may  be  specified,  in 
which  case  the  deleted  lines  are  saved  into  an 
internal  editor  buffer  (there  are  a-z  of  them). 
Internal  named  buffers  may  be  further  manipulated 
by  the  put  command  and  the  yank  command. 


File 

f ile<newname>  abbr:  f 

Prints  the  current  file  name  and  number  of  lines 
in  the  buffer.  If  <newname>  is  specified,  the 
current  file  name  is  replaced  with  <newname>. 


Full  Screen 

( . )fullscreen<count> 

abbr:  fu 

Enters  full  screen  mode  on  an  appropriate 
terminal.  The  addressed  line  appears  at  the  top 
of  the  full  screen  window  into  the  edit  buffer. 
The  <count>,  if  present  specifies  an  initial 
window  size  in  lines. 


Global 


(l,$)global  /pattern/<cmds> 

abbr :  g 

First  marks  each  line,  among  those  specified, 
which  matches  the  given  pattern.  Then  the  given 
command  list  is  executed  with  initially  set 

to  each  marked  line.  The  global  command  itself 
may  not  appear  in  <cmds>. 


Insert 


( . ) insert 
<text> 


abbr:  i 

Places  the  given  text  before  the  specified  line. 
This  command  differs  from  append  only  in  the 
placement  of  the  text. 
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Join 


( . , . +1 ) join<count > 

List 

( . , . )list<count > 


Mark 

( . )mark<x> 


Move 

( . , . )move<addr> 

Number 

( . , . )number<count> 

Print 

( . , . )<count> 


INTERMETRIC8  INCORPORATED 


abbr;  j 

Places  the  text  from  a  specified  range  of  lines 
together  on  one  line. 


abbrs  1 

Prints  the  specified  lines  in  an  unambiguous  way: 
a  few  non-printing  characters  (e.g.,  tab  and 
backspace)  are  represented  by  mnemonic 
overstrikes.  All  other  non-printing  characters 
are  printed  in  octal. 


Marks  the  specified  line  as  x  (a  single  lower 
case  letter).  The  addressing  form  'x  then 
addresses  this  line. 


abbr:  m 

The  move  command  repositions  the  specified  lines 
to  be  after  <addr>. 


abbr:  nu  or  # 

Prints  each  specified  line  preceded  by  its  buffer 
line  number. 


abbr:  p 

Prints  the  specified  lines. 
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W8Rf5330BB 


( . )put<buf fer> 


abbr:  pu 


Puts  back  previously  deleted  or  yanked  lines. 
Normally  used  with  delete  to  effect  movement  of 
lines  or  with  yank  to  effect  duplication  of 
lines.  If  no  <buffer>  is  specified,  then  the 
last  deleted  or  yanked  text  is  restored.  By 
using  a  named  buffer,  text  may  be  restored  that 
was  saved  in  that  buffer  at  any  previous  time  in 
the  edit  session. 


Quit 

quit  abbr:  q 

Causes  the  editor  to  terminate.  No  automatic 
write  of  the  edit  buffer  to  a  database  object  is 
performed.  However,  a  warning  message  is  issued 
if  the  file  has  changed  since  the  last  write 
command  and  the  editor  does  not  quit.  Another 
quit  command  immediately  after  the  warning 
message  will  cause  the  editor  to  discard  its 
buffer  and  terminate. 


Read 


( .  )read<f ile>  abbr:  r 

Places  a  copy  of  the  text  of  the  given  file  in 
the  editing  buffer  after  the  specified  line.  If 
no  file  name  is  present,  the  current  file  name  is 
used. 


( .  )readl<command>  abbr:  r 

Invokes  the  command  processor  to  process  the 
specified  command.  The  standard  output  of  the 
command  is  read  into  the  buffer  after  the 
specified  line. 


Set 

set<parameter> 

With  no  arguments,  prints  those  options  whose 
values  have  been  changed  from  their  defaults; 
with  <parameter>  'all'  it  prints  all  of  the 
option  values.  Legal  values  for  <parameter>  are 
given  in  Section  3. 2. 2. 6. 
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Source 


source <file>  abbr:  so 

Reads  and  executes  commands  from  the  specified 
file.  Source  commands  may  be  nested. 


Substitute 


(.,. Substitute  /<pattern>/<replacement>/<options><count> 

abbr:  s 

On  each  specified  line,  the  first  instance  of 
<pattern>  is  replaced  by  replacement  pattern 
<replacement>.  If  the  global  indicator  option 
character  'g'  appears,  then  all  instances  are 
substituted.  If  the  confirm  indication  character 
'c'  appears,  then  before  each  substitution,  the 
line  to  be  substituted  is  typed  with  the  string 
to  be  substituted  marked  with  • | '  characters.  By 
typing  a  'y'  one  can  cause  the  substitution  to  be 
performed  as  shown.  Any  other  input  causes  no 
change  to  take  place. 


Undo 

undo  abbr:  u 

Reverses  the  changes  made  in  the  buffer  by  the 
last  buffer  editing  command. 


Write 

(l,$)write<f ile>  abbr:  w 

Write  the  edit  buffer  back  to  <file>.  If  <file> 
is  omitted,  the  text  goes  to  the  current  file 
(usually  the  originally  edited  file). 

(l,$)write!<command> 

abbr:  w 

Writes  the  specified  lines  as  standard  input  to 
<command>. 


Yank 

( . , .  )yank<buf fer><count> 

abbr :  ya 

Places  the  specified  lines  in  the  named  buffer 
for  later  retrieval  via  put. 
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Escape  to  Command  Processor 
! <command > 

The  remainder  of  the  line  after  the  'I' 
character  is  sent  to  the  command  processor  for 
execution. 


(addr,addr) !<command> 

Takes  the  specified  address  range  and  supplies  it 
as  standard  input  to  <command>;  the  resulting 
standard  output  then  replaces  the  input  lines. 


Display  Line  Number 


(.  )  = 


Prints  the  line  number  of  the  addressed  line. 


Display  Line 

(.+1) 

An  address  alone  causes  the  addressed  line  to  be 
printed.  A  blank  line  (no  address)  prints  the 
next  line  in  the  file. 


3. 2. 3. 5  Substitute  and  Replacement  Patterns 


(a)  Pattern  Expressions.  A  pattern  expression  specifies  a  set  of 
strings  oi  characters.  A  member  of  this  set  of  strings  is  set  to  be 
matched  by  the  pattern  expression. 


(b)  Basic  Pattern  Expression  Summary.  The  following  basic 
constructs  are  used  to  construct  pattern  express ions : 

char  An  ordinary  character  matches  itself.  The 

characters  at  the  beginning  of  a  line. 

as  any  character  other  than  the  first, 

and  1 " 1  are  not  ordinary  characters  and  must 
be  escaped  (preceded)  by  '/'  to  be  treated  as 
such. 

*  At  the  beginning  of  a  pattern  forces  the  match 

to  succeed  only  at  the  beginning  of  a  line. 

$  At  the  end  of  a  pattern  expression  forces  the 

match  to  succeed  only  at  the  end  of  a  line. 
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t 


.  Matches  any  single  character  except  the  new  line 

character. 

[<string>]  Matches  any  (single)  character  in  the  class 
defined  by  <string>.  Most  characters  in  <string> 
define  themselves.  A  pair  of  characters 

separated  by  *- 1  in  <string>  defines  the  set  of 
characters  collating  between  the  specified  lower 
and  upper  bounds.  (E.g.,  '[a-z]'  as  a  pattern 
expression  matches  any  (single)  lower  case  letter 
if  the  collating  sequence  is  ASCII. )  If  the 
first  character  of  <string>  is  ' A',  then  the 
construct  matches  those  characters  not  in  the 
defined  set.  To  place  any  of  the  characters  ' 

’  l'»  or  in  <string>,  you  must  escape  them 

'  ith  a  preceding  '  v. 


(c)  Combinjr.?  attern  Expression  Primitives.  The  concatenation  of 
two  pattern  r%.  jes& ions  matches  the  leftmost  and  then  longest  string 
which  can  be  divided  with  the  first  piece  matching  the  first  pattern 
expression  and  th«  second  piece  matching  the  second.  Any  of  the 
(single  character  matching)  pattern  expressions  mentioned  above  may 
be  followed  by  the  character  to  form  a  pattern  expression  which 
matches  any  number  of  adjacent  occurrences  (including  0)  of 
characters  matched  by  the  pattern  expression  it  follows. 

The  character  may  be  in  a  pattern  expression,  and  matches 
the  text  which  defined  the  replacement  part  of  the  last  substitute 
command . 


(d)  Substitute  Replacement  Patterns.  The  basic  metacharacters  for 
the  replacement  pattern  are  '  and  ' Each  instance  of  is 
replaced  by  the  characters  which  the  pattern  expression  matched. 
The  metacharacter  1 ' '  stands,  in  the  replacement  pattern,  for  the 
defining  text  of  the  previous  replacement  pattern. 


3. 2. 3. 6  Option  Descriptions 

The  options  described  below  are  modified  by  the  set  command. 

(a)  Ada.  Default  is  noAda.  When  on,  changes  the  definition  of  a 
"word*  in  full  screen  mode  (e.g.,  for  use  in  'dw',  'cw',  etc.)  to  be 
that  of  an  Ada  lexical  unit  as  defined  in  Chapter  2  of  the  Ada  LRM. 
In  addition,  the  definition  of  a  "paragraph"  in  full  screen  mode  is 
redefined  to  be  delimited  by  matching  pairs  of  reserved  words  (e.g., 
begin-end,  loop-end  loop,  if-end  if,  etc.). 
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(b)  Autoindent  (ai).  Default  is  noai.  Autoindent  can  be  used  to 
ease  the  preparation  of  structured  program  text.  At  the  beginning 
of  each  append,  change,  or  insert  command  or  when  a  new  line  is 
opened  or  created  by  an  append,  change,  insert,  or  substitute 
operation  within  full  screen  mode,  the  editor  looks  at  the  line 
being  appended  (after  the  first  line  changed  or  the  line  inserted 
before)  and  calculates  the  amount  of  white  space  at  the  start  of  the 
line.  It  then  aligns  the  cursor  at  the  level  of  indentation  so 
determined. 

If  the  user  then  types  lines  of  text  in,  they  will  continue  to 
be  justified  at  the  displayed  indenting  level.  If  more  white  space 
is  typed  at  the  beginning  of  a  line,  the  following  line  will  start 
aligned  with  the  first  non-white  character  of  the  previous  line.  To 
back  the  cursor  up  to  the  preceding  tab  stop  one  can  hit  *D. 

Specially  processed  in  this  mode  is  a  line  with  no  characters 
added  to  it,  which  turns  into  a  completely  blank  line  (the  white 
space  provided  for  the  autoindent  is  discarded). 


(c)  List.  Default  is  nolist.  With  list,  all  printed  lines  will  be 
display ecf  unambiguously  as  in  the  list  command. 


(d)  Number ( nu ) .  Default  is  nonumber.  Causes  all  output  lines  to 
be  printed  with  their  line  numbers.  In  addition,  each  input  line 
will  be  prompted  for  by  supplying  the  line  number  it  will  have. 


(e)  Prompt.  Default  is  prompt.  Command  mode  input  is  prompted 
with  a  1 V  • 


(f)  Tabstop  ( ts ) .  Default  is  ts*8.  The  editor  expands  tabs  in  the 
input  file  to  Be  on  tabstop  boundaries  for  the  purposes  of  display. 


(g)  Wrapscap  (ws) .  Default  is  ws.  Wrapscap  searches  using  the 
pattern  expressions  in  addressing  will  wrap  around  past  the  end  of 
the  file. 


(h)  Wrapmargin  (wm) .  Default  is  wm*0.  Wrapmargin  defines  a  margin 
for  automatic  wrapover  of  text  during  input  in  full  screen  mode. 
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3*2.4  Full  Screen  Mode 

On  an  appropriate  terminal,  the  user  may  elect  to  operate  the 
editor  in  full  screen  mode  via  the  full  screen  command.  In  this 
mode  the  CRT  screen  becomes  a  window  into  the  editors  buffer.  All 
of  the  non-fullscreen  commands  are  still  available.  However,  when 
the  cursor  is  moved  around  the  CRT  screen  an  entire  new  set  of 
"keystroke"  commands  become  available.  These  commands  cause 

movement  or  changes  in  the  visual  image  displayed  on  the  screen.  It 
is  always  possible  to  enter  non-fullscreen  commands  by  using  the  1 >" 
keystroke  command,  which  places  the  cursor  at  the  bottom  line  of  the 
display  and  then  accepts  a  non-fullscreen  command. 

Most  of  the  full  screen  keystroke  commands  move  the  cursor 
around  in  the  edit  buffer.  There  are  commands  to  move  the  cursor 
forward  and  backward  in  units  of  words,  sentences  and  paragraphs.  A 
small  set  of  operators,  like  'd9  for  delete  and  9c9  for  change,  are 
combined  with  the  motion  commands  to  perform  operations  such  as 
delete  word  or  delete  paragraph,  in  a  simple  and  natural  way.  This 
regularity  and  the  mnemonic  assignment  of  commands  to  keys  make  the 
editor  command  set  easier  to  remember  and  use. 

The  various  types  of  movement  and  modification  commands  are 
grouped  together  and  described  below.  Note  the  use  of  the  notation 
,An'  for  the  control-n  character. 


3.2. 4.1  Movement  within  the  Buffer 

(a)  Scrolling  and  Paging 

*D  Scroll  Down 

AU  Scroll  Up 

AF  Forward  a  page 

AB  Backward  a  page 


(b)  Searching,  goto 


/<text> 


position  cursor  at  the  first  occurrence  of  this 
string  on  a  line  after  the  comment  line. 


?<text> 


same  as  /<text>  except  searches  back  in  buffer. 


n  go  to  next  line  with  an  occurrance  of  the 

previously  mentioned  <text>. 

G  Go  to.  If  preceded  by  a  number  (e.g.,  1G)  goes 

to  the  first  line  of  the  buffer.  A  9G9  with  no 
prefixed  number  goes  to  the  end  of  the  buffer. 
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(c)  Moving  Around  the  Screen 

+  advance  to  next  line  (return  key  has  some  function), 

first  non-white  character. 

move  to  preceeding  line,  first  non-white  character. 

H  move  to  top  line  (Home)  of  current  screen,  first 

non-white  character. 

M  move  to  Middle  of  current  screen,  first  non-white 

character. 

L  move  to  Last  line  of  screen,  first  non-white 

character. 

move  to  next  line  maintaining  column  position, 
move  to  previous  line  maintaining  column  position. 

(d)  Moving  Within  a  Line 

w  advance  cursor  to  next  word, 

b  backup  cursor  a  word  at  a  time, 

e  advance  to  end  of  current  word. 

<space>  move  right  one  character. 

<backspace>  move  left  one  character. 


(e )  Inserting 

i  enters  insert  mode.  Everything  typed  until  an  ESC 

(Escape  key)  is  typed  is  inserted  to  the  left  of  the 
cursor. 

a  enters  insert  mode  to  the  right  of  the  cursor 

(appends)  until  ESC  is  typed. 

o  open  new  lines  after  the  current  line. 

0  open  new  lines  before  the  current  line. 
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3 . 2 . 4 . 2  Corrections 


x  delete  (x-out)  the  character  under  the  cursor, 

r  replace  the  character  at  the  cursor  position  with  the 

next  character  typed. 

s  substitute  characters  (terminated  by  ESC)  for  the 

character  at  the  cursor  position. 


Note:  the  s  and  x  commands  may  be  preceded  by  a  numeric  count  to 
indicate  the  number  of  characters  to  be  involved. 

d  delete  operator.  It  is  followed  by  a  "type" 

indication  as  in  'dw*  to  delete  a  word  or  db  to  delete 
the  character  preceeding  the  cursor  (delete 
backwards ) . 

c  change  operator  -  similar  to  d  but  accepts  text  up  to 

ESC  to  replace  indicated  context.  (E.g.r  CW  changes 
the  next  word). 

.  repeats  the  last  changing  command. 


3. 2.4. 3  Line  Operations 


dd 


cc 


deletes  the  current  line, 
change  a  whole  line. 


Note  that  dd  and  cc  may  be  preceeded  by  counts. 


3. 2.4.4  Undo 

u  reverses  the  last  change  mode. 

U  restores  current  line  to  its  state  before  last  changes 

were  made  to  it. 
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3.2.4. 5 
) 

( 

> 

} 

xy 

xp 

Note : 
option 


Higher  Level  Text  Objects 

move  forward  one  sentence, 
backward  sentence, 
forward  paragraph, 
backward  paragraph. 

yank  copy  of  text  object  into  buffer  'x1 
a-z  ) . 

put  text  from  buffer  x  after  cursor. 

A  paragraph  begins  after  each  empty  line  unless 
is  set.  See  Section  3. 2. 3*6. 
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I  mission  5 

$  of  § 

^  Rome  Air  Development  Center  ^ 

^  PAVC  plan*  and  executes  research,  development,  test  and  % 

\  selected  acquisition  programs  in  support  o&  Command,  Control  S 
&  Communications  and  Intelligence  (C^I)  activities .  Technical  « 
\  and  engineering  support  mXhin  areas  o£  technical  competence  C 
jfc  is  provided  to  ESV  Program  O^ices  IPOs)  and  other  ESP  > 

jJ  elements .  The  principal  technical  mission  aAeas  are  % 

?  communications ,  electromagnetic  guidance  and  contAol,  Sur- 
J  veillance  ofi  gAound  and  aerospace  objects,  intelligence  data  ^ 
¥  collection  and  handling,  information  system  technology,  v 

&  ionospheric  pAopagation,  solid  state  sciences,  microvoave  ” 

\  physics  and  electronic  reliability,  maintainability  and 
&  compatibility. 


